home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
IRIX Base Documentation 1998 November
/
IRIX 6.5.2 Base Documentation November 1998.img
/
usr
/
share
/
catman
/
p_man
/
cat3
/
Xm
/
XmTabListReplacePositions.z
/
XmTabListReplacePositions
Wrap
Text File
|
1998-10-30
|
5KB
|
133 lines
XXXXmmmmTTTTaaaabbbbLLLLiiiissssttttRRRReeeeppppllllaaaacccceeeePPPPoooossssiiiittttiiiioooonnnnssss((((3333UUUUXXXXNNNN))))IIIIXXXX SSSSyyyysssstttteeeemmmmXXXXmmmmVVVVTTTTaaaabbbbLLLLiiiissssttttRRRReeeeppppllllaaaacccceeeePPPPoooossssiiiittttiiiioooonnnnssss((((3333XXXX))))
NNNNAAAAMMMMEEEE
XXXXmmmmTTTTaaaabbbbLLLLiiiissssttttRRRReeeeppppllllaaaacccceeeePPPPoooossssiiiittttiiiioooonnnnssss - A convenience function that
creates a new tab list with replacement tabs
SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
#include <Xm/Xm.h>
XXXXmmmmTTTTaaaabbbbLLLLiiiisssstttt XXXXmmmmTTTTaaaabbbbLLLLiiiissssttttRRRReeeeppppllllaaaacccceeeePPPPoooossssiiiittttiiiioooonnnnssss(
XXXXmmmmTTTTaaaabbbbLLLLiiiisssstttt oooollllddddlllliiiisssstttt,
CCCCaaaarrrrddddiiiinnnnaaaallll ****ppppoooossssiiiittttiiiioooonnnn____lllliiiisssstttt,
XXXXmmmmTTTTaaaabbbb ****ttttaaaabbbbssss,
CCCCaaaarrrrddddiiiinnnnaaaallll ttttaaaabbbb____ccccoooouuuunnnntttt);
VVVVEEEERRRRSSSSIIIIOOOONNNN
This page documents Motif 2.1.
DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
XXXXmmmmTTTTaaaabbbbLLLLiiiissssttttRRRReeeeppppllllaaaacccceeeePPPPoooossssiiiittttiiiioooonnnnssss creates a new tab list that
contains the contents of _o_l_d_l_i_s_t, but with the tabs at the
positions in _p_o_s_i_t_i_o_n__l_i_s_t replaced with copies of the
corresponding tabs in _t_a_b_s. A warning message is displayed
if a specified position is invalid; for example, if the
value is a number greater than the number of tabs in the tab
list.
This function deallocates the original tab list after
extracting the required information. It is the caller's
responsibility to free the tabs in _t_a_b_s by using the
XXXXmmmmTTTTaaaabbbbFFFFrrrreeeeeeee function.
_o_l_d_l_i_s_t Specifies the tab list. The function deallocates
the tab list after extracting the required
information.
_p_o_s_i_t_i_o_n__l_i_s_t
Specifies an array of positions of the tabs to be
replaced. The position of the first tab is 0
(zero), the position of the second tab is 1, and
so on.
_t_a_b_s Specifies an array of the replacement tabs.
_t_a_b__c_o_u_n_t Specifies the number of elements in _p_o_s_i_t_i_o_n__l_i_s_t
and _t_a_b_s.
RRRREEEETTTTUUUURRRRNNNN
If _t_a_b_s, _o_l_d_l_i_s_t, or _p_o_s_i_t_i_o_n__l_i_s_t is NULL, or _t_a_b__c_o_u_n_t is
0 (zero), returns _o_l_d_l_i_s_t. Otherwise, this function returns
the new tab list. The function allocates space to hold the
returned tab list. The application is responsible for
managing the allocated space. The application can recover
the allocated space by calling XXXXmmmmTTTTaaaabbbbLLLLiiiissssttttFFFFrrrreeeeeeee.
Page 1 (printed 10/24/98)
XXXXmmmmTTTTaaaabbbbLLLLiiiissssttttRRRReeeeppppllllaaaacccceeeePPPPoooossssiiiittttiiiioooonnnnssss((((3333UUUUXXXXNNNN))))IIIIXXXX SSSSyyyysssstttteeeemmmmXXXXmmmmVVVVTTTTaaaabbbbLLLLiiiissssttttRRRReeeeppppllllaaaacccceeeePPPPoooossssiiiittttiiiioooonnnnssss((((3333XXXX))))
RRRREEEELLLLAAAATTTTEEEEDDDD
XXXXmmmmTTTTaaaabbbbLLLLiiiisssstttt(3).
Page 2 (printed 10/24/98)